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FOREWORD 



XLT86 TM "is a Digital Research software product that aids in the 
translation of 8080 assembly language programs to equivalent 8086 
programs. XLT86 takes the CP/M® and MP/M TM - environment into 
account, so that translated programs operate properly under both 
CP/M-86 TM - and MP/M-86 TM ". XLT86 can also be used as a teaching tool 
by examining the output when XLT86 is applied to existing 8080 
programs. Unlike other 8086 translators, XLT86 uses global data 
flow analysis techniques to determine 8080 register usage and reduce 
the number of generated 8086 instructions. 

The XLT86 translator is available for operation under CP/M and 
MP/M for the 8080, 8085, and Z80® microprocessors with a minimum 
40K Transient Program Area (TPA) . XLT86 requires a 64K CP/M system 
to effectively translate any significant 8080 programs. Using a 
4Mhz Z80 microprocessor, XLT86 translates programs at approximately 
120 to 150 lines per minute, depending upon backup storage access 
speed. XLT86 is written in PL/I-80 TM " and thus can be adapted for 
use on computer systems that support Subset G. Specifically, XLT86 
is available for cross-development on the Digital Equipment 
Corporation VAX 11/750 or 11/780 minicomputer, operating with the 
standard DEC VMS software. However, programs are supplied in 
machine code form, so it is not necessary to own PL/I-80 or any of 
its subsystems to operate XLT86. 

The XLT86 system components, including the files XLT86.COM, 
XLT00.OVL, and XLT01.OVL, are distributed in IBM-compatible single 
density disk form. Before operating XLT86, copy these system 
components to a working disk and save the distribution disk for 
archive purposes. If the working disk medium can be dismounted, it 
must be marked with the notice shown below to properly comply with 
the Software License Agreement: 

Copyright © 1981 
Digital Research, Inc. 

This User's Guide presents the overall translation process, 
along with operator interface and command syntax. This manual also 
describes the format of the translated program, including the 
details of the 8080 to 8086 operation code translation. 
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SECTION 1 
THE TRANSLATION PROCESS 



1.1 Input and Output Files 

XLT86 reads an 8080 program from a file with type ASM and 
produces a file of type A86 containing the equivalent translated 
8086 assembly language program. The filename for the 8080 source 
program, as well as filenames for all output files from XLT86, is 
taken from the command line typed by the operator. For example, the 
console command: 

XLT86 DUMP 

executes the XLT86 program using the file "DUMP. ASM" as input. The 
translation produces the output file "DUMP.A86". 

The 8080 source program must be in a form acceptable to the 
standard Digital Research assembly language translators ASM, MAC, or 
RMAC. XLT86 processes conditional assembly statements, and produces 
an output program that results from evaluation of the particular 
conditions included in the 8080 program. However, macro 
definitions, macro invocations, and repeat loops are not altered in 
the translation. To properly translate programs that include macros 
or repeat loops, first assemble the programs under MAC or RMAC to 
produce a printer listing file of type PRN . Rename this PRN file to 
type ASM and edit the file to remove the beginning column positions, 
resulting in a file acceptable as input to XLT86. The A86 output 
file is now in a form acceptable to the Digital Research ASM86 
assembler, requiring little or no modification for execution under 
CP/M-86 and MP/M-86. 

XLT86 produces two additional files: a PRN file and a $$$ 
file. A file of type PRN contains error lines and messages along 
with optional listing and trace information. The PRN file is in a 
form suitable for listing on the system printer and contains 
embedded form-feed and tab characters. A temporary file of type $$$ 
is also created during translation. This temporary file is 
automatically deleted upon normal completion of XLT86. 

The XLT86 program consists of a "root module" called XLT86.COM, 
which is loaded and executed when you enter the XLT86 command line 
shown above. There are two additional "overlays" called XLT00.OVL 
and XLT01.OVL that must be present on your default disk drive. 
These two overlays are automatically loaded and executed at the 
appropriate time during the translation. 
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1.2 Translation Phases 



1.2 Translation Phases 

The translation itself takes place in five phases. Each phase 
has a specific name that appears at the console during translation 
so that the operator can monitor the progress of XLT86. Table 1-1 
lists the phase names. 



Table 1-1 



XLT86 Translation Phases 



Phase 



Meaning 



Symbol Setup 
Setup Blocks 

Join Blocks 



determines the location of each 
symbol in the 8080 source program. 



determine the 
necessary for 
analysis. 



"Basic Blocks" 
the data f low 



List Blocks 



Translate-86 



construct a "Directed Graph" 

connecting each basic block, 

corresponding to program flow of 
control. 

produce an optional list of Basic 
Blocks following flow analysis 
showing register and flag usage for 
each 8080 instruction. 

translates the 8080 instructions to 
8086 form, using the information 
gathered by the flow analysis. 



The command line: 



XLT86 DUMP 



activates the XLT86 translator using the DUMP. ASM program as input. 
The default action of XLT86 prints the name of each phase at the 
console as the translation proceeds, as shown below. 

Symbol Setup 
Setup Blocks 
Join Blocks 
List Blocks 
Translate-86 
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1.2 Translation Phases 



The files processed by the "XLT86 DUMP" command are shown in 
Figure 1-1, below. 



Source 



DUMP. ASM 



Temp 



DUMP.$$$ 



Output 




DUMP.A86 



Print 



DUMP.PRN 



Figure 1-1. Processed Files 



All files are placed on the drive specified by the operator as the 
prefix on the source filename. In the above example, all files are 
placed on the current default drive, which must also contain the 
XLT86 program along with its overlays. An alternative form: 

XLT86 B:DUMP 

overrides the default drive and obtains the source file from drive 
B. XLT86 creates the output, temporary, and print files on drive B 
as well. When several drives are available, it may be advantageous 
to place the various files on separate disks. In this case, you 
must use XLT86 "parameters," described in the following section, to 
override the default values. 
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2.1 Parameter Syntax 

Several XLT86 parameters can be included in the command line by 
the operator or embedded within the 8080 source program to control 
the translation process. Parameters are grouped together into a 
parameter list enclosed within square brackets: 

[pi p2 ... pn] 

where pi through pn denote one or more parameters optionally 
separated by blanks. When included on the command line, the XLT86 
invocation appears as follows: 

XLT86 filename [pi p2 ... pn] 

When included within the source program, the opening bracket of the 
parameter list must begin in the first column position. The 
parameters denoted by pi through pn are one or two character 
sequences in upper- or lower-case, with optional intervening blanks, 
as listed in Table 2-1, below. 



Table 2-1. Translation Parameters 



Parameter 



Meaning 



Ax 

B 
C 
J 



N 



R 



Place the A86 file on drive x where x = A, B, 
..., P. 

Produce a list of Basic Blocks in the PRN file. 

Assume the 8086 "compact model" for execution. 

Translate conditional jumps to short 
conditionals. 

Send the PRN file directly to the system 
printer . 

Show the line and statement number being 
processed. 

Place the PRN file on drive x where x = A, B, 

. . . , c . 

Assume all flags active at subroutine returns. 
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2.1 Parameter Syntax 



Table 2-1. (continued) 



Parameter 


Meaning 


S 


Assume non-overlapping 8086 code and data 




segments. 


T 


Place the $$$ file on drive x where x = A, B, 




. . . f c . 


80 


Create an 8080 assembly listing in the PRN 




file. 


86 


Create an 8086 line and statement listing. 



2.2 The B (Block Trace) Parameter 

The A (A86) , P (PRN) , and T (TMPJ parameters allow you to 
select alternate disk drives for use during the translation process 
when only limited disk space is available on each drive. Otherwise, 
disk drives are selected as described above. 

The B (Block Trace) parameter provides a trace in the PRN file 
showing register usage information collected by the data flow 
analyzer. This parameter is not normally selected since the trace 
information is of no particular value unless you are interested in 
detailed register usage. The B parameter trace consists of a 
sequence of register usage tables for each Basic Block in the form 
shown below. 



Block At 011E (subr) , A86 = 083F 

Entry Active: B-D-HL-AOZSPI Exit Active: BCDEHL- 



stmt# I opcode uses | op I vl | v2 I opcode kills I live regs 



23| AOZSPI 

24| a 

25| 

26 1 — 



PUSH I PSW 
MOV I E 
MVI I C 
CALL I 0005 



| IB-D-HL-A- 

A| E IB-DEHL— 

05 I -C IBCDEHL— 

I IBCDEHL— 



The Basic Block address in the original 8080 program is listed 
and the type of block is identified. The block type is "subr" for 
subroutines, "code" for main-line code, and "data" for data blocks. 
The A86 address is an approximation of the corresponding 8086 
address used to determine short and long branch jump ranges. The 
remaining information shows register and flag use at block entry and 
at each instruction within the block. The registers and flags are 
displayed as a vector of letters and hyphens, where each letter 
represents the presence of a register or flag in the display, and 
each hyphen signifies that the corresponding register or flag is 
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2.2 The B (Block Trace) Parameter 



absent in the vector. Given that all registers and flags are 
present, the display appears as follows: 

BCDEHLMAZOSPI 

Table 2-2 lists the letter denotations of the above display. 



Table 2-2. Letter Denotations for Registers and Flags 



Letter 


Meaning 


B 


Register 


B, 


or 


high(BC) 


C 


Register 


c. 


or 


low (BC) 


D 


Register 


D, 


or 


high(DE) 


E 


Register 


E, 


or 


low (DE) 


H 


Register 


H, 


or 


high(HL) 


L 


Register 


L, 


or 


low (HL) 


M 


Register 


M r 


memory operand 


A 


Register 


A, 


8-bit Accumulator 





Overflow 


Fl 


ag, 


carry or borrow 


Z 


Zero Flac 


f 






S 


Sign Flag 






P 


Even Parity 


Flag 


I 


Interdigit < 


Carry Flag 



The registers active upon entry are listed first. In the 
example shown above, the data flow analysis has determined that the 
B, D, and HL registers, along with all flag registers, are in use 
upon entry to the block. The active registers following this block 
are then listed, consisting of the BC, DE, and HL register pairs. 
Then each instruction in the Basic Block is given, with a preceding 
statement number that can be cross-referenced with the 8080 source 
program. The instruction itself is listed with the hexadecimal 
values of its two optional parameters. 



The 



the 



"opcode uses" field shows the register set used by , 

operation code, while the "opcode kills" field lists the registers 
destroyed by the operation. The "live registers" field provides the 
information used by the Translate-86 phase to minimize the generated 
code. This field lists the registers and flags that are referenced 
following the instruction and is derived by ex< 



by examining the Directed 
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Graph corresponding to the 8080 source program. Again r the 
information collected by the flow analyzer is optionally displayed 
using the B parameter. This display is not required for normal 
operation of the translator. 

2.3 The C (Compact) Parameter 

The C (Compact) parameter causes XLT86 to generate 8086 machine 
code using the "Compact Memory Model" described in the CP/M-86 
System Guide. Under normal circumstances, XLT86 assumes the "8080 
Memory Model" where code and data segments overlap. To accomplish 
this overlap of segments, the program is analyzed to determine Basic 
Blocks that contain code and data. The program is assumed to begin 
with a code segment and, if a data segment is encountered as defined 
by a sequence of DS, DB, or DW statements, XLT86 produces the 
following statements that provide the proper transition: 

L@n EQU $ 
DSEG 
ORG Offset L@n 

Similarly, the transition from a data segment back to a code 
sequence is marked by the generated statements: 

L@n EQU $ 
CSEG 
ORG Offset L@n 

where L@n is a sequentially generated label. The labels are 
generated as required by XLT86, taking the form: 

L@l L@2 L@3 L@4 L@32767 

Enabling the "C" parameter prevents the code and data segments from 
overlapping. In this case, the transition from code to data and 
data to code is marked by either 

DSEG 

or 

CSEG 

respectively. See also the description of the S (Segments) 
parameter. When enabled, the S parameter completely overrides the C 
parameter. 
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2.4 The J (Jump) Parameter 

The J (Jump) parameter enables the short jump analysis option 
of XLT86. When enabled, XLT86 translates 8080 conditional jumps to 
either short conditional jumps or negated short conditional jumps 
followed by short unconditional jumps, depending upon the byte count 
to the target of the jump. That is, a "JZ x" instruction becomes 
either 

JZ x 

• • • • 

x: 

or 

JNZ L@n 
JMPS x 
L@n: 

The first case results if the label "x" is within the range of a 
short jump, while the second form results from a target label beyond 
the range of a short jump. The J parameter is enabled by default, 
and should be disabled using the NOJ form described below only if 
you want to manually edit your conditional jumps following program 
translation. 



2.5 The L (List) Parameter 

The L (List) parameter sends the listing file directly to the 
system printer, thus avoiding the intermediate PRN file. The system 
printer, or printer driver, must handle form-feeds (ctl-L) and tabs 
(ctl-I) to every eighth column position. If your printer does not 
properly support these characters, you can leave the L parameter 
disabled and use the CP/M PIP utility command form: 

PIP LST:=filename.PRN[T8F] 

where the PIP parameter M T8" expands tabs to blanks at every eighth 
column, and the "F" parameter deletes the form-feed character on 
transmission. 



2.6 The N (Number) Parameter 

The N (Number) parameter displays the current line and 
statement number on CRT-type console devices as the translation 
proceeds. Each line and statement number is displayed with an 
intervening carriage return, without a line feed, so that each 
successive display overwrites the previous value. In this way, you 
can easily monitor the progress of XLT86 as it proceeds through the 
source program during the translation. 
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2.7 The R (Return) Parameter 



2.7 The R (Return) Parameter 

The R (Return) parameter overrides the default assumptions 
about register usage at the end of a subroutine. XLT86, by default, 
assumes that all registers are in use at the end of a subroutine in 
the absence of additional information. This is a safe, but possibly 
restrictive, assumption that might cause more 8086 code to be 
generated near the return statements of each subroutine. If you 
know that the entire 8080 program being translated contains 
subroutines that do not return flag registers, then you should 
include the R parameter in the command line to reduce the amount of 
generated code. 

Alternatively, you can precede the return statements of various 
subroutines with " [R] " parameters when they do not return flag 
registers, as long as balancing "[NOR]" parameters, described below, 
are included to return to the default assumptions, where necessary. 

2.8 The S (Segment) Parameter 

The S (Segment) parameter informs XLT86 that the original 
source program contains embedded CSEG and DSEG directives that 
delimit the code and data segments. In this case, XLT86 makes no 
attempt to derive the code and data segment information and, 
instead, assumes that the CSEG and DSEG directives passed through to 
the 8086 program correctly define the appropriate segments. The S 
parameter is automatically set when the source program contains 
ASEG, CSEG, or DSEG directives, and completely overrides the effect 
of the C (Compact) parameter. 

2.9 The 80 Parameter 

The 80 parameter causes XLT86 to produce a pseudo-assembly 
listing of the original 8080 source program, giving the source line 
and statement number along with the assembled machine code location. 
If the B parameter is simultaneously enabled, additional Basic Block 
information precedes each straight-line code segment. When both 80 
and B are enabled, the trace appears as shown below: 



Basic Block (2) 011E 





Predecessors: 


0119 


0111 0105 0100 




Successors 


: 0125 






Reg's Killed: 


-C-E- 







Reg's Used : 




an? cdt 






JnUitOlrl. 


22 


22 011E 


pr: 




23 


23 011E 




push psw 


24 


24 011F 




mov e,a 


25 


25 0120 




mvi c,lst 


26 


26 0122 




call bdos 
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Each Basic Block of the listing is preceded by the Basic Block 
Header consisting of the location (011E in the example above) , a set 
of predecessor blocks where the program flow of control comes from 
(0119, 0111, 0105, and 0100), and a set of successor blocks where 
program flow could continue (0125, above). The set of registers 
killed are listed, along with the set of registers used by the 
operation codes within the block. No global data flow information 
is displayed in this trace (see the B parameter described earlier) . 

2.10 The NO Parameter 

The two character sequence "NO" preceding the B, C, J, L, N, R, 
S, 80, and 86 parameters negates the effect of the parameter once it 
has been set. Further, the A, P, and T parameters are ignored when 
they occur within the source file and are effective only on the 
command line. The parameters B, C, J, L, N, R, S, 80, and 86 
parameters, along with their negated forms, can occur in the command 
line or within the source program. When they occur within the 
program, they apply to the segment of code following their 
occurrence. Assuming that the default drive is d, where d is a 
valid drive code A, B, ..., P, the default values assumed for each 
parameter are identical to the complete, but redundant, command line 
shown below: 

XLT86 d: filename [Ad NOB NOC J NOL NON Pd NOS NOR Td NO80 N086] 
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3.1 Translated Program Format 

XLT86 constructs the 8086 program from the original 8080 
program by first analyzing the program register usage. Then, using 
the collected information, XLT86 translates each label, operation 
code, and operand expression into an equivalent 8086 program 
segment. In performing the translation, XLT86 uses as many program 
fragments from the original 8080 source program as possible. These 
program fragments include labels, expressions, and comment fields. 
Due to differences in assembly language formats, however, labels and 
expressions might be altered somewhat to maintain their original 
meaning. 

The translation occurs line-by-line, where each 8080 source 
line may contain several statements delimited by exclamation 
symbols. XLT86, however, always generates a single statement per 
output line. The output line includes an optional label in column 
one, followed by a single tab character. The translated operation 
code field is placed immediately following the tab character. If 
the operation code has one or two operand fields, another tab 
character is included and the operand fields are inserted. The 
operand fields themselves are constructed by either translating 8080 
registers to their 8086 equivalents, or through the construction of 
an expression that is the translation of the original form. If a 
comment field is present in the source program, it is copied to the 
8086 program intact with sufficient leading tabs to position the 
comment to column forty, if that position has not already been 
reached. Comments beginning in column one are reproduced without 
leading tab characters. Further, comments that begin in column one 
with the character "*" are started, instead, by the two character 
sequence ";*" to maintain compatibility with ASM-86. 

For pseudo-assembly purposes, the assumed origin of the 8080 
program is 0100H, corresponding to the base of the TPA under CP/M. 
This assumed origin resolves label addresses during pseudo-assembly 
and does not normally affect the translation process. However, if 
an ORG statement is encountered at the beginning of the program 
before any code or data is encountered, the program origin is set to 
the value given in the operand field of the ORG statement. 

Program-relative operand references, along with absolute 
addresses, are allowed in the source program. In this case, XLT86 
generates a label of the form "L@n" at the target location. For 
example below, the 8080 instruction sequence shown to the left 
results in the 8086 program shown to the right: 

NOP L@l: NOP 

NOP NOP 

JMP $-2 JMPS L@l 
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3.1 Translated Program Format 



Similarly, the absolute 8080 assembly language shown to the 
left below results in the program shown to the right: 



ORG 300H 

NOP 

NOP 

JMP 300H 



L@l: 



ORG 300H 

NOP 

NOP 

JMP L@l 



In this case, the ORG statement is necessary to override the default 
assumption. 

From this last example, it appears that XLT86 is capable of 
translating 8080 programs produced through disassembly. 
Unfortunately, disassemblers cannot generally distinguish between 
code and data areas. If the code and data sections can be separated 
into distinct areas, where the code is disassembled with absolute 
address operands and the data areas consist of DS, DB, and DW 
operations, then XLT86 performs the translation. 

Operand fields are translated according to their context and, 
for notational purposes, we make the following definitions. 



Table 


3-1 


Operand Field Abbreviations 


Abbreviation 


Definition 


ib 




immediate byte operand (MVI A,ib) 


1W 




immediate word operand (LXI H,iw) 


mb 




byte in memory (STA x) 


mw 




word in memory (LHLD x) 


mn 




near memory (CALL x) 


rb 




byte in register (ADD B) 


rw 




word in register (DAD B) 



The translation of an expression is denoted by a prime (') 
following the expression type. Thus, ib is translated to ib' , iw to 
iw' , and so forth. Register translation takes place according to 
the following table. 



Table 3-2. Register Translation 



8080 Register 


(rb) 


8086 


Register (rb' ) 


A 






AL 


B 






CH 


C 






CL 


D 






DH 


E 






DL 


H 






BH 


L 






BL 
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3.1 Translated Program Format 



The M (Memory) register has no direct equivalent in the 8086 
environment, so XLT86 produces an "equate" statement in the 
following form at the beginning of each program. 

M EQU Byte Ptr [BX] 

Thus, the M register remains unchanged in the translation with the 
assumption that the BX register contains the offset to the proper 
memory location. 

The 16-bit register pair translation occurs as shown in Table 
3-3, below. 



Table 3-3. 16-Bit Register Translation 



8080 Register (rw) 


8086 Register (rw* ) 


PSW 


AX 


B 


CX 


D 


DX 


H 


BX 


SP 


SP 



The 8080 PSW and 8086 AX register have a loose correspondence 
depending upon register usage at the time of translation. The exact 
correspondence is defined below under the PUSH and POP operators. 

3.2 Translated Program Content 

Expressions are normally composed of literal constants, data 
variable references, program label references, and register 
references. XLT86 computes the type of each expression as the 
translation proceeds, resulting in one of the followng expressions. 





Table 3-4. Expressions 


Expression 


Meaning 


constant 


consists only of literal constants 


variable 


consists of zero or more constants and one 
or more variable references 


label 


consists of zero or more constants or 
variables, and one or more labels 


register 


consists of zero or more constants, vari- 
ables, or labels and one or more register 
references 
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3.2 Translated Program Content 



The translation of ib, iw, mb, mw, and mn is described in 
Table 3-5, below. This translation takes place after XLT86 scans 
the expression to determine its type, as described above. 



Table 3-5. Operand Field Translation 



Operand Field 



Translation 



ib and iw 



mb 



mw 



mn 



ib* and iw 1 are constructed from the 
original ib and iw by first 
determining the expression type. If 
the type is "constant," the 
expression ib or iw remains 
unchanged in the translation. 

Otherwise, for each variable, label, 
dollar sign ($), or regis- ter 
reference in the expression, XLT86 
changes the reference, denoted by x, 
to "(Offset x)" so that the 
resulting expression ib' or iw* 
represents a CS or DS relative 
offset computation. 

The resulting expression mb' is 
constructed from the original 
expression mb according to the type 
of mb. If mb is "constant" then mb 1 
becomes "Byte Ptr .mb" denoting a 
single byte operand located at a 
literal constant address relative to 
DS or CS. Otherwise, the expression 
mb 1 becomes "Byte Ptr mb" denoting a 
byte variable or label address. 

Similar to mb, mw 1 becomes "Byte Ptr 
.mw" if mw is "constant" and "Byte 
Ptr mw" otherwise. 

The expression mn' is the same as the 
original mn unless there is no 
literal label at the target address. 
In this latter case, a label of the 
form "L@n" is created at the target 
address, which becomes the value of 
mn 1 . 



Due to differences in 8080 and 8086 program formulation 
requirements, not all valid 8080 expressions can be successfully 
converted to valid 8086 expressions. Thus, you must be aware that 
additional editing is required if your translated program produces 
errors during assembly with ASM-86. In particular, expressions that 
use arbitrary operations upon constants, variables, labels, and 
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registers are unlikely to assemble correctly under ASM-86, or any 
other assembler that uses the Intel conventions. 

In the translation table given below, the 8080 operation code 
is shown to the left, with the translated 8086 code sequence shown 
to the right. In many cases, the registers that are live at the 
point where the 8080 operation code occurs determine the exact 
sequence of code that is generated. In these cases, the alternative 
forms are given separately. Conditional assembly notation specifies 
the alternative forms, with the introduction of the following two 
pseudo- functions: 



and 



live(rl,r2, ..., rn) 



short (mn 1 ) 



The "live" function takes a variable number of register arguments 
and results in a TRUE value if one or more of these registers is 
live at the point of translation. Otherwise, the "live" function 
results in a FALSE value. In the Section 2 example for the B 
parameter, statement 24 (MOV E,A) has the live register set given by 
the vector: 

B-DEHL 

so that 

live(B,C,D) = TRUE and live(A,0) = FALSE 

The "short" function is used in the translation of conditional 
jump instructions where the value of short(mn') is TRUE if the 
target of the translated jump address mn 1 is within the range of a 
conditional jump, or if the "J" parameter is enabled. Otherwise, 
short(mn') results in a FALSE value. XLT86 also uses the notation 
in Section 2 for label generation. The form "L@n" represents labels 
produced sequentially, starting at n = 1, used in the translation of 
conditional calls, returns, and conditional jumps outside the range 
of an 8086 conditional transfer. The CC (Call if Carry) operator, 
for example, translates to a jump conditional to a generated label 
followed by a direct call. The generated label is then inserted, as 
shown in the expansion of the 8080 instruction CC SUBR: 

JNB L@l 
CALL SUBR 
L@l: 

Table 3-6 gives the translation of each operation code. Note 
in particular that the following BDOS entry operations: 

CALL CALL 5 JMP JMP 5 

are treated as special cases that are translated to Interrupt 224, 
reserved by Intel Corporation for entry to CP/M-86 and MP/M-86. 
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Table 3-6. Translation Table 



Operation Code 


Translation 


ACI ib 


ADC 


AL,ib* 


ADC rb 


ADC 


AL, rb' 


ADD rb 


ADD 


AL,rb' 


ADI ib 


ADD 


AL,ib' 


ANA rb 


AND 


AL f rb' 


ANI rb 


AND 


AL,rb' 


CALL 


MOV 
MOV 
INT 


CL,0 
DL,0 
224 


CALL 5 


INT 


224 


CALL mn 


CALL mn' 


CC mn 


JNB L@n 
CALL mn' 
L@n: 


CM mn 


JNS L@n 
CALL mn' 
L@n: 


CMA 


NOT 


AL 


CMC 


CMC 




CMP rb 


CMP 


AL, rb' 


CNC mn 


JNAE L@n 
CALL mn' 
L@n: 


CNZ mn 


JZ L@n 
CALL mn' 
L@n: 
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Tabl 


e 3-6- (continued) 


Operation Code 


Translation 


CP mn 




JS L@n 
CALL mn' 
L@n: 


CPE mn 




JNP L@n 
CALL mn' 
L@n: 


CPI ib 




CMP AL,ib' 


CPO mn 




JP L@n 
CALL mn' 
L@n: 


CZ mn 




JNZ L@n 
CALL mn 1 
L@n: 


DAA 




DAA 


DAD rw 




IF rw * H 
SHL BX,1 
ELSE 

IF live(O) AND NOT 
live(Z,S,P,I) 
ADD BX,rw' 
ELSE 

IF NOT live(O) AND 
live(Z,S,P,I) 
LAHF 

ADD BX,rw' 
SAHF 
ELSE 
LAHF 

ADD BX f rw' 
RCR SI,1 
SAHF 

RCL SI,1 
ENDIF 
ENDIF 
ENDIF 


DEC rb 




DEC rb' 


DCX rw 




DEC rw' 


DI 




CLI 


EI 




STI 
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Table 


3-6. 


(continued) 


Operation Code 


Translation 


HLT 




HLT 


IN ib 




IN AL,ib' 


INR rb 




INC rb' 


INX rw 




IF NOT live(Z,S,P,I) 

INC rw' 

ELSE 

LAHF 

INC rw' 

SAHF 

ENDIF 


JC mn 




IF short(mn' ) 

JB mn* 

ELSE 

JNB L@n 

JMPS mn' 

L@n: 

ENDIF 


JM mn 




IF short(mn' ) 

JS mn' 

ELSE 

JNS L@n 

JMPS mn' 

L@n: 

ENDIF 


JMP 




MOV CL,0 
MOV DL,0 
INT 224 
RET 


JMP 5 




INT 224 
RET 


JMP mn 




JMPS mn' 


JNC mn 




IF short (mn' ) 

JNB mn' 

ELSE 

JNAE L@n 

JMPS mn' 

L@n: 

ENDIF 



All Information Presented Here is Proprietary to Digital Research 

20 



XLT86 User's Guide 



3.2 Translated Program Content 



Table 3-6. (continued) 



Operation Code 


Translation 


JNZ mn 


IF short(mn' ) 




JNZ mn 1 




ELSE 




JZ L@n 




JMPS mn" 




L@n: 




ENDIF 


JP mn 


IF short (mn' ) 




JNS mn' 




ELSE 




JS L@n 




JMPS mn' 




L@n: 




ENDIF 


JPE mn 


IF short(mn' ) 




JPE mn' 




ELSE 




JNP L@n 




JMPS mn' 




L@n: 




ENDIF 


JPO mn 


IF short(mn' ) 




JPO mn* 




ELSE 




JP L@n 




JMPS mn' 




L@n: 




ENDIF 


JZ mn 


IF short(mn*) 




JZ mn 1 




ELSE 




JNZ L@n 




JMPS mn' 




L@n: 




ENDIF 


LDA mb 


MOV AL,mb' 


LDAX rw 


MOV SI,rw* 




MOV AL, [SI] 


LHLD mw 


MOV BX,mw* 


LXI rw,iw 


MOV rw' ,iw' 


MOV rbl f rb2 


MOV rbl' ,rb2' 
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Tabl 


e 3-6. (continued) 


Operation Code 


Translation 


MVI rb, 


ib 


MOV rb' , ib' 


NOP 




NOP 


ORA rb 




OR AL,rb' 


ORI ib 




OR AL f rb' 


OUT ib 




OUT ib' ,AL 


PCHL 




JMP BX 


POP rw 




POP rw 1 

IF rw = PSW AND live 

(0,Z,S,P,I) 
XCHG AL,AH 
SAHF 
ELSE 

IF rw = PSW AND live (A) 

XCHG AL,AH 

ENDIF 
ENDIF 


PUSH rw 




IF rw = PSW AND live (A) 

LAHF 

XCHG AL,AH 

PUSH AX 

XCHG AL,AH 

ELSE 

if rw = PSW 

LAHF 

XCHG AL,AH 

PUSH AX 

ELSE 

PUSH rw' 

ENDIF 
ENDIF 


RAL 




RCL AL,1 


RAR 




RCR AL,1 


RC 




JNB L@n 

RET 

L@n: 


RET 




RET 


RLC 




ROL AL f l 
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Table 


3-6. (continued) 


Operation Code 


Translation 


RM 




JNS L@n 

RET 

L@n: 


RNC 




JNAE L@n 

RET 

L@n: 


RNZ 




JZ L@n 

RET 

L@n: 


RP 




JS L@n 

RET 

L@n: 


RPE 




JNP L@n 

RET 

L@n: 


RPO 




JP L@n 

RET 

L@n: 


RRC 




ROR AL f l 


RST 


ib 


INT ib' 


RZ 




JNZ L@n 

RET 

L@n: 


SBB 


rb 


SBB AL,rb' 


SBI 


ib 


SBB AL,ib' 


SHLD 


mw 


MOV mw' ,BX 


SPHL 




MOV SP,BX 


STA 


mb 


MOV mb' r AL 


STAX 


rw 


MOV DI,rw* 
MOV [DI] ,AL 


STC 




STC 


SUB 


rb 


SUB AL r rb* 


SUI 


ib 


SUB AL,Lb' 
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Table 3-6. 


(continued) 


Operation Code 


Translation 




XCHG 


XCHG BX,DX 




XRA rb 


XOR AL,rb* 




XRI ib 


XOR AL,ib' 




XTHL 


MOV BP,SP 
XCHG BX f [BP] 
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SECTION 4 
XLT86 ERROR MESSAGES 

4.1 Psuedo-assembly Process Error Messages 

XLT86 issues error messages that fall into two categories: 
those produced by the pseudo-assembly process, and those produced 
during translation. Errors in the first category are not considered 
fatal, but are simply annotated in the source listing file following 
the line in which the error occurs. If errors are present, the 
message: 

Number of Errors: n 

is displayed at the console following the pseudo-assembly. Examine 
the PRN file to determine if the errors are significant. Error 
messages take the form: 

** Error: e **, Near t 

where e is one of the error codes, and t is a program element near 
the position where the error occurred. Table 4-1 lists the error 
codes. 

Table 4-1. XLT86 Error Codes 



Error Code 


Meaning 


Bad Flag 


invalid parameter list [pi ... pn] 


Balance 


Unmatched right parenthesis or 
missing trailing string quote. 


Boundary 


Invalid program boundary, usually 
results from a branch to the middle 
of an instruction. 


Convert 


Cannot convert an operand to internal 
form. 


End-Line 


The end of a program line contains 
extraneous characters. 


Exp Ovfl 


Expression stack overflow; the ex- 
pression is nested too deeply. 


Gtr 7 


An expression produced a value 
greater than 7, where a value from 
0-7 is required. 
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4.1 Psuedo-assembly Process Error Messages 



Table 4-1 



(continued) 



Error Code 


Meaning 


Gtr 255 


An expression produced a value 
greater than 255, where a value from 
0-255 is required. 


Mov M,M? 


The source line contains the invalid 
instruction MOV M,M. 


No Comma 


Missing comma where comma is 
required. 


No Value 


A label or variable was encountered 
that does not have an assigned 
value. 


Not Impl 


The instruction or directive is not 
implemented in XLT86. 


Phase 


A label or variable has a different 
value on two passes through the 
source program. 


Str Len 


A string was encountered that exceeds 
the capacity of XLT86, check for 
missing right quote mark. 


Value 


The value produced by an expression 
is not compatible with the context 
in which it occurs. 



4.2 Translate-86 Error Messages 

The Translate-86 phase also produces a limited number of error 
messages. All errors produced by this phase are fatal, and cause 
immediate termination of XLT86. Table 4-2 lists these error 
messages. 
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4.2 Translate-86 Error Messages 





Table 4-2. 


Translate-86 Error Messages 


Error 


Message 


Meaning 


Bad 


Oper 


Invalid 8080 operation code was 
encountered during translation; 
probably due to bad disk I/O 
operation. Check for hardware 
controller faults. 


Not 


BDOS 


A CALL or JMP occurred below the base 
origin of the program where the 
target is not 0000H (warm boot) or 
0005H (BDOS entry) . 


Phase (B) 


The Directed Graph does not 
correspond to the source program at 
the Basic Block level; usually due 
to a hardware malfunction. 


Phase (S) 


The Directed Graph does not 
correspond to the source program at 
the statement level; usually due to 
a hardware malfunction 



An error produced by Translate-86 is accompanied by the console 
error message: 

Fatal Error (See PRN file) 
to indicate that such an error occurred. 



4.3 Memory Overflow 

The XLT86 program occupies approximately 30K bytes of main 
memory. The remainder of memory, up to the base of CP/M, stores the 
program graph that represents the 8086 program being translated. 
The error message: 

ERROR (7) "Free Space Exhausted" 

is issued if the program graph exceeds available memory. A 64K CP/M 
system allows translation of 8080 programs of up to approximately 
6K. 

The above error causes XLT86 to terminate. To continue, you 
must divide your source program into smaller modules and retry the 
translation. 
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SAMPLE PROGRAM TRANSLATIONS 



The DUMP. ASM program presented here and normally included as 
a sample assembly language program with CP/M illustrates the 
translation process. The XLT86 command line: 

XLT86 DUMP [8086] 

produces the first example shown below. The "80" parameter selects 
the 8080 program listing option, while the "86" parameter selects 

the 8086 listing option. XLT86 places full lines of dashes ( " ■-") 

between the Basic Blocks in the 8080 listing. This translation of 
the DUMP program, however, requires modification to run under CP/M- 
86. In particular, the DUMP. ASM program contains initialization 
code that saves the entry SP (statements 34 to 37) and resets the SP 
to a local stack (statement 39) . The return statement following the 
FINIS label (statement 95) returns control to the CCP. 

To perform an exactly equivalent sequence of operations, you 
must also save the stack segment register (SS) upon entry to the 
DUMP program, and restore this value before executing the return. 
Further, the simple RET operation must be replaced by a Far Return 
(RETF) to balance the original Far Call from the CCP. A simpler 
solution is to eliminate the initialization code (statements 33 
through 39) and use the CCP' s built-in 96 byte stack. Control 
returns to the CCP by executing a RETF at statement 95. If you want 
to use a local stack, set the SS register to the value of DS upon 
entry, and set SP to the Offset of STKTOP. Control returns to the 
CCP through execution of function call #0 in place of the RET in 
statement 95, as follows: 

MOV CL,0 

MOV DL,0 

INT 224 

The second listing shows the Basic Block information 
collected by the flow analyzer, and produced by the command line: 

XLT86 DUMP [B] 

where the "B" parameter selects the Basic Block trace. Under normal 
circumstances, either of the commands shown below are sufficient and 
reduce the amount of trace information: 

XLT86 DUMP [N] 



or 



XLT86 DUMP 
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Appendix A Sample Program Translations 



The first command is used only with a CRT-type device where the 
carriage-return character does not cause an automatic line-feed (see 
the description of the "N" parameter) . 



1 


1 


0100 




FILE 


DUMP PROGRAM, READS AN INPUT F 


2 


2 


0100 










3 


3 


0100 




COPYRIGHT (C) 1975, 1976, 1977, 197 


4* 


4 


0100 




DIGITAL RESEARCH 




5 


5 


0100 




BOX 


579, PACIFIC 


GROVE 


6 


6 


0100 




CALIFORNIA, 93950 


7 


7 


0100 










8 


8 


0100 




ORG 


100H 




9 


9 


0100 


BDOS 


EQU 


0005H 


?DOS ENTRY POINT 


10 


10 


0100 


CONS 


EQU 


1 


?READ CONSOLE 


11 


11 


0100 


TYPEF 


EQU 


2 


•TYPE FUNCTION 


12 


12 


0100 


PRINTF 


EQU 


9 


? BUFFER PRINT ENTRY 


13 


13 


0100 


BRKF 


EQU 


11 


; BREAK KEY FUNCTION 


14 


14 


0100 


OPENF 


EQU 


15 


?FILE OPEN 


15 


15 


0100 


READF 


EQU 


20 


;READ FUNCTION 


16 


16 


0100 


r 








17 


17 


0100 


FCB 


EQU 


5CH 


?FILE CONTROL BLOCK 


18 


18 


0100 


BUFF 


EQU 


80H 


', INPUT DISK BUFFER 


19 


19 


0100 


7 








20 


20 


0100 


} 


NON 


GRAPHIC CHARACTERS 


21 


21 


0100 


CR 


EQU 


0DH 


; CARRIAGE RETURN 


22 


22 


0100 


LF 


EQU 


0AH 


?LINE FEED 


23 


23 


0100 


} 








24 


24 


0100 


i 


FILE 


CONTROL BLOCK DEFINITIONS 


25 


25 


0100 


FCBDN 


EQU 


FCB+0 


■DISK NAME 


26 


26 


0100 


FCBFN 


EQU 


FCB+1 


•FILE NAME 


27 


27 


0100 


FCBFT 


EQU 


FCB+9 ; 


DISK FILE TYPE (3 


28 


28 


0100 


FCBRL 


EQU 


FCB+12 ; 


FILE'S CURRENT REE 


29 


29 


0100 


FCBRC 


EQU 


FCB+1 5 ; 


FILE'S RECORD COUN 


30 


30 


0100 


FCBCR 


EQU 


FCB+32 ; 


CURRENT (NEXT) REC 


31 


31 


0100 


FCBLN 


EQU 


FCB+33 ; 


FCB LENGTH 


32 


32 


0100 


r 








33 


33 


0100 


i 


SET I 


JP STACK 




34 


34 


0100 




LXI 


H,0 




35 


35 


0103 




DAD 


SP 




36 


36 


0104 




ENTRY STACK POINT 


n ER IN HL FROM THE 


37 


37 


0104 




SKLD 


OLDSP 




38 


38 


0107 




SET J 


3P TO LOCAL STACK AREA (RESTORE 


39 


39 


0107 




LXI 


SP,STKTO£ 


> 


40 


40 


010A 




READ 


AND PRINT SUCCESSIVE BUFFERS 


41 


41 


010 A 




CALL 


SETUP ; 


SET UP INPUT FILE 


42 


42 


010D 




CPI 


255 ; 


255 IF FILE NOT PR 


43 


43 


010F 




JNZ 


OPENOK ; 


SKIP IF OPEN IS OK 


44 


44 


0112 


} 








45 


45 


0112 


t 


FILE 


NOT THERE, GIVE ERROR MESSAGE 


46 


46 


0112 




LXI 


D,OPNMSG 




47 


47 


0115 




CALL 


ERR 
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48 



48 0118 



JMP 



FINIS ;T0 RETURN 



49 
50 
51 
52 
53 
54 



49 011B 

50 011B 

51 011B 

52 011D 

53 0120 

54 0120 



OPENOK: ;OPEN OPERATION OK, SET BUFFER INDE 

MVI A,80H 

STA IBP ;SET BUFFER POINTER 
; HL CONTAINS NEXT ADDRESS TO PRINT 

LXI H,0 ; START WITH 0000 



55 
56 
57 
58 



55 0123 

56 0123 

57 0123 

58 0124 



GLOOP 



PUSH 
CALL 



H 
GNB 



;SAVE LINE POSITION 



59 
60 



59 0127 

60 0128 



POP H ; RECALL LINE POSITI 
JC FINIS ; CARRY SET BY GNB I 



61 


61 


012B 


62 


62 


012C 


63 


63 


012C 


64 


64 


012C 


65 


65 


012D 


66 


66 


012F 



MOV B,A 

PRINT HEX VALUES 

CHECK FOR LINE FOLD 

MOV A,L 

ANI OFH ; CHECK LOW 4 BITS 

JNZ NONUM 



67 
68 



67 0132 

68 0132 



PRINT LINE NUMBER 
CALL CRLF 



69 
70 
71 



69 0135 

70 0135 

71 0135 



CHECK FOR BREAK KEY 
CALL BREAK 



72 


72 


0138 


73 


73 


0138 


74 


74 


0139 


75 


75 


013C 


76 


76 


013C 


77 


77 


013D 



ACCUM LSB = 1 IF CHARACTER READY 

RRC ;INTO CARRY 

JC FINIS ; DON'T PRINT ANY MO 



MOV 
CALL 



A,H 
PHEX 



78 
79 



78 0140 

79 0141 



MOV 
CALL 



A f L 
PHEX 



80 


80 


0144 


81 


81 


0144 


82 


82 


0145 


83 


83 


0147 



NONUM; 



INX 


H 


MVI 


A,' ' 


CALL 


PCHAR 



;TO NEXT LINE NUMBE 



84 
85 



84 014A 

85 014B 



MOV 
CALL 



A,B 
PHEX 



86 



86 014E 



JMP 



GLOOP 



87 


87 


0151 


88 


88 


0151 


89 


89 


0151 



FINIS 



END OF DUMP, RETURN TO CCP 
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90 
91 



90 0151 

91 0151 



(NOTE THAT A JMP TO 0000H REBOOTS) 
CALL CRLF 



92 
93 
94 
95 



92 0154 

93 0157 

94 0158 

95 0158 



LHLD OLDSP 

SPHL 

STACK POINTER CONTAINS CCP'S STACK 

RET ;TO THE CCP 



96 

97 

98 

99 

100 

101 

102 

103 



96 0159 

97 0159 

98 0159 

99 0159 

100 0159 

101 0159 

104 015C 

105 015E 



SUBROUTINES 

BREAK: ; CHECK BREAK KEY (ACTUALLY ANY KEY 
PUSH H! PUSH D! PUSH B; ENVIRONMENT 
MVI C,BRKF 
CALL BDOS 



104 
105 



106 0161 
109 0164 



POP B! POP DI POP H; ENVIRONMENT RE 
RET 



106 


110 


0165 


107 


111 


0165 


108 


112 


0165 


109 


115 


0168 


110 


116 


016A 


111 


117 


016B 



PCHAR: ; PRINT A CHARACTER 

PUSH H! PUSH DI PUSH B; SAVED 
MVI C,TYPEF 
MOV E,A 
CALL BDOS 



112 
113 



118 
121 



016E 
0171 



POP B! POP D! POP H; RESTORED 
RET 



114 
115 
116 
117 



122 0172 

123 0172 

124 0172 

125 0174 



CRLF 



MVI 
CALL 



A,CR 
PCHAR 



118 
119 



126 
127 



0177 
0179 



MVI 
CALL 



A,LF 
PCHAR 



120 



128 017C 



RET 



121 


129 


017D 


122 


130 


017D 


123 


131 


017D 


124 


132 


017D 


125 


133 


017F 


126 


134 


0181 


127 


135 


0184 


128 


136 


0184 


129 


137 


0186 



PNIB: ; PRINT NIBBLE IN REG A 

ANI 0FH ;LOW 4 BITS 
CPI 10 
JNC P10 



LESS THAN OR EQUAL TO 9 
ADI ' ' 
JMP PRN 



130 
131 
132 



138 0189 

139 0189 

140 0189 



P10 



GREATER OR EQUAL TO 10 
ADI 'A f - 10 
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133 



141 018B 



PRN: 



CALL 
RET 



PCHAR 



134 



142 018E 



135 


143 


018F 


136 


144 


018F 


137 


145 


018F 


138 


146 


0190 


139 


147 


0191 


140 


148 


0192 


141 


149 


0193 


142 


150 


0194 



PHEX: ; PRINT HEX CHAR IN REG A 
PUSH PSW 
RRC 
RRC 
RRC 
RRC 
CALL PNIB ; PRINT NIBBLE 



143 
144 



151 0197 

152 0198 



POP 
CALL 



PSW 
PNIB 



145 



153 019B 



RET 



146 


154 


019C 


147 


155 


019C 


148 


156 


019C 


149 


157 


019C 


150 


158 


019E 



ERR: ; PRINT ERROR MESSAGE 

D,E ADDRESSES MESSAGE ENDING WITH " 
MVI C,PRINTF ; PRINT BUFF 
CALL BDOS 



151 



159 01A1 



RET 



152 
153 
154 
155 
156 
157 



160 01A2 

161 01A2 

162 01A2 

163 01A2 

164 01A5 

165 01A7 



GNB: ;GET NEXT BYTE 
LDA IBP 
CPI 80H 
JNZ GO 



158 
159 
160 
161 



166 01AA 

167 01AA 

168 01AA 

169 01AA 



READ ANOTHER BUFFER 



CALL 



DISKR 



162 
163 



170 01AD 

171 01AE 



ORA 
JZ 



A 
GO 



;ZERO VALUE IF READ 
;FOR 'ANOTHER BYTE 



164 
165 
166 



172 01B1 

173 01B1 

174 01B2 



END OF DATA, RETURN WITH CARRY SET 

STC 

RET 



167 
168 
169 
170 
171 
172 
173 
174 
175 
176 



175 
176 
177 
178 
179 
180 
181 
182 
183 
184 



01B3 
01B3 
01B3 
01B4 
01B6 
01B7 
01BA 
01BA 
01BA 
01BD 



GO 



;READ THE BYTE AT BUFF+REG A 

LS BYTE OF BUFFER 
DOUBLE PRECISION I 
INDEX=INDEX+1 
BACK TO MEMORY 

POINTER IS INCREMENTED 

SAVE THE CURRENT FILE ADDRESS 

LXI H,BUFF 

DAD D 



MOV 


E,A ; 


MVI 


D,0 


INR 


A 


STA 


IBP 
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111 


185 


01BE 


178 


186 


01BE 


179 


187 


01BF 


180 


188 


01BF 


181 


189 


01C0 


182 


190 


01C1 


183 


191 


01C1 


184 


192 


01C1 


185 


193 


01C1 


186 


194 


01C2 


187 


195 


01C5 


188 


196 


01C5 


189 


197 


01C8 


190 


198 


01CA 



ABSOLUTE CHARACTER ADDRESS IS IN HL 

MOV A,M 

BYTE IS IN THE ACCUMULATOR 

ORA A ; RESET CARRY BIT 

RET 



SETUP: ;SET UP FILE 

OPEN THE FILE FOR INPUT 

XRA A ;ZERO TO ACCUM 

STA FCBCR ; CLEAR CURRENT RECO 



LXI 


D,FCB 


MVI 


C,OPENF 


CALL 


BDOS 



191 
192 



199 01CD 

200 01CD 



255 IN ACCUM IF OPEN ERROR 
RET 



193 


201 


01CE 


194 


202 


01CE 


195 


203 


01CE 


196 


206 


01D1 


197 


207 


01D4 


198 


208 


01D6 



DISKR: ;READ DISK FILE RECORD 
PUSH H! PUSH D! PUSH B 
LXI D,FCB 
MVI C,READF 
CALL BDOS 



199 
200 



209 01D9 
212 01DC 



POP Bi POP Dl POP H 
RET 



201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 



213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 



01DD 
01DD 
01DD 
01F3 
0213 
0213 
0213 
0215 
0217 
0217 
0217 



FIXED MESSAGE AREA 
SIGNON: DB 'FILE DUMP VERSION 1.4$' 
OPNMSG: DB CR,LF,'NO INPUT FILE PRESEN 



; VARIABLE AREA 
IBP: DS 2 
OLDSP: DS 2 

; STACK AREA 
DS 64 



; INPUT BUFFER POINT 
; ENTRY SP VALUE FRO 



; RESERVE 32 LEVEL S 



212 
213 
214 



224 0257 

225 0257 

226 0257 



STKTOP: 



END 
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1 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 




1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
'35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 



M 



BDOS 

CONS 

TYPEF 

PRINTF 

BRKF 

OPENF 

READF 

FCB 
BUFF 



CR 
LF 



FCBDN 
FCBFN 
FCBFT 
FCBRL 
FCBRC 
FCBCR 
FCBLN 



EQU Byte Ptr 0[BX] 

FILE DUMP PROGRAM, READS AN INPUT FILE AND 

COPYRIGHT (C) 1975, 1976, 1977, 1978 

DIGITAL RESEARCH 

BOX 579, PACIFIC GROVE 

CALIFORNIA, 93950 



ORG 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 

EQU 
EQU 



100H 

0005H 

1 

2 

9 

11 

15 

20 

5CH 
80H 



NON GRAPHIC CHARACTERS 
EQU ODH 
EQU OAH 

FILE CONTROL BLOCK DEFINITIONS 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



FCB+0 

FCB+1 

FCB+9 

FCB+12 

FCB+1 5 

FCB+32 

FCB+33 



DOS ENTRY 
READ CONSO 
TYPE FUNCT 
BUFFER PRI 
BREAK KEY 
FILE OPEN 
READ FUNCT 

FILE CONTR 
INPUT DISK 



; CARRIAGE R 
;LINE FEED 



DISK NAME 
FILE NAME 
DISK FILE 
FILE'S CUR 
FILE'S REC 
CURRENT (N 
FCB LENGTH 



CALL 


SETUP 


CMP 


AL,255 


JNZ 


OPENOK 



OPENOK 



SET UP STACK 

MOV BX,0 

ADD BX,SP 

ENTRY STACK POINTER IN HL FROM THE CCP 

MOV Word Ptr OLDSP,BX 

SET SP TO LOCAL STACK AREA (RESTORED AT FIN 

MOV SP, (Offset STKTOP) 

READ AND PRINT SUCCESSIVE BUFFERS 

SET UP INP 
255 IF FIL 
SKIP IF OP 

FILE NOT THERE, GIVE ERROR MESSAGE AND RETU 

MOV DX, (Offset OPNMSG) 

CALL ERR 

JMPS FINIS ;TO RETURN 

;OPEN OPERATION OK, 
MOV AL,80H 

MOV Byte Ptr IBP,AL ;SET BUFFER 

HL CONTAINS NEXT ADDRESS TO PRINT 
MOV BX,0 ; START WITH 
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55 


55 


56 


56 


57 


57 


58 


58 


59 


59 


60 


60 


61 


61 


62 


62 


63 


63 


64 


64 


65 


65 


66 


66 


67 


67 


68 


68 


69 


69 


70 


70 


71 


71 


72 


72 


73 


73 


74 


74 


75 


75 


76 


76 


77 


77 


78 


78 


79 


79 


80 


80 


81 


81 


81 


81 


81 


81 


82 


82 


83 


83 


84 


84 


85 


85 


86 


86 


87 


87 


88 


88 


89 


89 


90 


90 


91 


91 


92 


92 


93 


93 


94 


94 


95 


95 


96 


96 


97 


97 


98 


98 


99 


99 


100 


100 


101 


101 


101 


102 


101 


103 


102 


104 


103 


105 


104 


106 


104 


107 



GLOOP 



NONUM: 



FINIS 



BREAK 



PUSH 


BX 


CALL 


GNB 


POP 


BX 


JB 


FINIS 


MOV 


CH,AL 


PRINT 


HEX VALUES 


CHECK 


FOR LINE FOLD 


MOV 


AL,BL 


AND 


AL,0FH 


JNZ 


NONUM 


PRINT 


LINE NUMBER 


CALL 


CRLF 



;SAVE LINE 

; RECALL LIN 
; CARRY SET 



; CHECK LOW 



CHECK FOR BREAK KEY 

CALL BREAK 

ACCUM LSB = 1 IF CHARACTER READY 



ROR 


AL f 1 


JB 


FINIS 


MOV 


AL,BH 


CALL 


PHEX 


MOV 


AL,BL 


CALL 


PHEX 


LAHF 




INC 


BX 


SAHF 




MOV 


AL, ' 


CALL 


PCHAR 


MOV 


AL,CH 


CALL 


PHEX 


JMPS 


GLOOP 



;INTO CARRY 
; DON'T PRIN 



;TO NEXT LI 



END OF DUMP, RETURN TO CCP 

(NOTE THAT A JMP TO 0000H REBOOTS) 

CALL CRLF 

MOV BX,Word Ptr OLDSP 

MOV SP,BX 

STACK POINTER CONTAINS CCP'S STACK LOCATION 

RET ;TO THE CCP 



SUBROUTINES 



PUSH 


BX 


PUSH 


DX 


PUSH 


CX 


MOV 


CL,BRKF 


INT 


224 


POP 


CX 


POP 


DX 



; CHECK BREA 
; ENVIRONME 
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104 
105 
106 
107 
108 
108 
108 
109 
110 
111 
112 
112 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
137 
137 
137 
138 
139 
140 
141 
142 
143 
143 
143 
144 
145 
146 
147 
148 
149 



108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
145 
145 
145 
146 
147 
148 
149 
150 
151 
151 
151 
152 
153 
154 
155 
156 
157 



PCHAR 



CRLF: 



PNIB: 



P10: 
PRN: 



PHEX: 



Appendix A Sai 


POP 


BX 


RET 




PUSH 


BX 


PUSH 


DX 


PUSH 


CX 


MOV 


CL,TYPEF 


MOV 


DL,AL 


INT 


224 


POP 


CX 


POP 


DX 


POP 


BX 


RET 




MOV 


AL r CR 


CALL 


PCHAR 


MOV 


AL, LF 


CALL 


PCHAR 


RET 





Sample Program Translations 

; ENVIRONME 
; PRINT A CH 
; SAVED 



; RESTORED 



AND AL,0FH 

CMP AL,10 

JNB P10 

LESS THAN OR EQUAL TO 9 

ADD AL , • ' 

JMPS PRN 



; PRINT NIBB 
; LOW 4 BITS 



GREATER OR EQUAL TO 
ADD AL, 'A' - 10 
CALL PCHAR 
RET 



10 



; PRINT HEX 



LAHF 

XCHG 

PUSH 

XCHG 

ROR 

ROR 

ROR 

ROR 

CALL 

POP 

XCHG 

SAHF 

CALL 

RET 



AL,AH 
AX 

AL,AH 
AL f l 

AL,1 

AL,1 

PNIB 

AX 

AL,AH 

PNIB 



; PRINT NIBB 



ERR: 



; PRINT ERRO 
D,E ADDRESSES MESSAGE ENDING WITH "$" 
MOV CL r PRINTF ; PRINT BUFF 



All Information Presented Here is Proprietary to Digital Research 

37 



XLT86 User's Guide 



Appendix A Sample Program Translations 



150 


158 


151 


159 


152 


160 


153 


161 


154 


162 


155 


163 


156 


164 


157 


165 


158 


166 


159 


167 


160 


168 


161 


169 


162 


170 


163 


171 


164 


172 


165 


173 


166 


174 


167 


175 


168 


176 


169 


177 


170 


178 


171 


179 


172 


180 


173 


181 


174 


182 


175 


183 


176 


184 


177 


185 


178 


186 


179 


187 


180 


188 


181 


189 


182 


190 


183 


191 


184 


192 


185 


193 


186 


194 


187 


195 


188 


196 


189 


197 


190 


198 


191 


199 


192 


200 


193 


201 


194 


202 


195 


203 


195 


204 


195 


205 


196 


206 


197 


207 


198 


208 


199 


209 


199 


210 


199 


211 


200 


212 



INT 
RET 



224 



GNB: 



;GET NEXT B 



GO: 



MOV AL,Byte Ptr IBP 

CMP AL,80H 

JNZ GO 

READ ANOTHER BUFFER 



CALL DISKR 

OR AL,AL ;ZERO VALUE 

JZ GO ;FOR ANOTHE 

END OF DATA, RETURN WITH CARRY SET FOR EOF 

STC 

RET 

READ THE B 
LS BYTE OF 
DOUBLE PRE 
INDEX=INDE 
. BACK TO ME 

POINTER IS INCREMENTED 

SAVE THE CURRENT FILE ADDRESS 

MOV BX,BUFF 

ADD BX , DX 

ABSOLUTE CHARACTER ADDRESS IS IN HL 

MOV AL , M 

BYTE IS IN THE ACCUMULATOR 

OR AL,AL ; RESET CARR 

RET 



MOV 


DL,AL 


MOV 


DH,0 


INC 


AL 


MOV 


Byte Ptr IBP,AL 



SETUP 



OPEN THE FILE FOR INPUT 

XOR AL,AL 

MOV Byte Ptr .FCBCR,AL 



;SET UP FIL 

;ZERO TO AC 
; CLEAR CURR 



DISKR: 



MOV 


DX,FCB 


MOV 


CL,OPENF 


INT 


224 


255 IN 


ACCUM IF OPEN ERROR 


RET 




PUSH 


BX 


PUSH 


DX 


PUSH 


CX 


MOV 


DX,FCB 


MOV 


CL,READF 


INT 


224 


POP 


CX 


POP 


DX 


POP 


BX 


RET 





;READ DISK 
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200 
200 
200 
201 
202 
203 
204 
206 
207 
208 
209 
210 
211 
212 
213 
214 



212 
212 
212 
213 
214 
215 
216 
218 
219 
220 
221 
222 
223 
224 
225 
226 



L@l 



EQU 

DSEG 

ORG 



Offset L@l 



SIGNON 
OPNMSG 

IBP 
OLDSP 



STKTOP 



FIXED MESSAGE AREA 

DB 'FILE DUMP VERSION 1.4$' 

DB CR f LF,'NO INPUT FILE PRESENT ON DIS 

VARIABLE AREA 

RS 2 ; INPUT BUFF 

RS 2 ; ENTRY SP V 



STACK AREA 
RS 64 
RS 

END 



; RESERVE 32 



LIST 



O F 



BASIC 



Block At 0005 (subr) , A86 = 0005 
Entry Active: 



BLOCKS 



Exit Active: 

I stmt# I opcode uses I op I vl I v2 I opcode kills I live regs 



Block At 0100 (code) , A86 = 0100 

Entry Active: BCDE A Exit Active: BCDEHL-A- 



stmt# I opcode uses I op I vl I v2 I opcode kills 



live regs 



34| ILXI I H| 0000 I HL I BCDEHL-A- 

35 1 HL | DAD I SP I I HL — I BCDEHL-A- 

37| HL |SHLD|0215| I I BCDEHL-A- 

39 1 ILXI I Ml 0257 | I BCDEHL-A- 

41| ICALLI01C1I I IBCDEHL-A- 



Block At 010D (code) , A86 = 0115 
Entry Active: BCDEHL-A— 



Exit Active: BCDEHL-AOZSPI 



|stmt#| opcode uses 


1 op 


i vl | v2 


I opcode kills I live regs I 


1 421 A 

| 43| z 


ICPI 
IJNZ 


1 FF 1 ! 
I011BI I 


1 OZSPI I BCDEHL-AOZSPI 1 

1 — 1 RfTlPHT AH7QDT 1 


I 1 D^UCinLi rtUAorl | 



Block At 0112 (code) , A86 = 011C 

Entry Active: BC — HL-AOZSPI Exit Active: BCDEHL-AOZSPI 



stmt# I opcode uses 



op I vl | v2 I opcode kills | live regs 



46 
47 



LXI I DI01F3I — DE I BCDEHL-AOZSPI 

CALLI019CI I I BCDEHL-AOZSPI 
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Block At 0118 (code) , A86 = 0122 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

I 481 IJMP 101511 I I BCDEHL-AOZSPI I 

Block At 011B (code) , A86 = 0125 

Entry Active: BCDE OZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs | 

I 511 IMVI I A I 80 1 A | BCDE AOZSPI I 

I 521 A ISTA 10213 1 I I BCDE AOZSPI I 

I 54| ILXI I HI 0000 I HL | BCDEHL-AOZSPI | 

Block At 0123 (code) , A86 = 012D 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 



|stmt#| opcode uses 


1 op I vl I v2 


I opcode kills I live regs I 


1 57 1 HL 

1 CO 1 _ _ _. 


IPUSHI Hi I 
|CALL|01A2| I 


1— — — Inrnpur iri7CDT 1 


1 1 D\*utLtlU i\\JLi3ir 1 | 

— — — _ — 1 HPnPHT 1A7CDT 1 


1 Do | — — — — 





Block At 0127 (code) , A86 = 0136 

Entry Active: BCDE AOZSPI Exit Active: BCDEHL-AOZSPI 



|stmt#| opcode uses 


1 op I vl i v2 


I opcode kills I live regs I 


1 CO I _ _ _ 


IPOP | Hi 
IJC 101511 


1 HL I BCDEHL-AOZSPI 1 

1 — — —._ — — _ —-_ 1 RPnPHT AH7CDT 1 


1 oy i — — — 

| 6o| o 





Block At 012B (code) , A86 = 0141 

Entry Active: -CDEHL-A Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 

I 611 A I MOV I B| A|B I BCDEHL 

I 64 1 L I MOV I A I L| A I BCDEHL-A 

I 65 1 A |ANI I OF | I AOZSPI | BCDEHL-AOZSPI 

I 66 1 Z |JNZ 10144 1 | I BCDEHL-AOZSPI 



Block At 0132 (code) , A86 = 014C 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl ! v2 I opcode kills I live regs 

| 68 1 I CALL 1*0 172 | |- I BCDEHL-AOZSPI 
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Block At 0135 (code) , A86 = 014F 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

I 71| | CALL I 0159 I I I BCDEHL-AOZSPI I 



Block At 0138 (code) , A86 = 0152 

Entry Active: BCDEHL-A-ZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

I 731 A |RRC I I I AO I BCDEHL-AOZSPI | 

I 74| |JC 101511 I I BCDEHL-AOZSPI I 

Block At 013C (code), A86 = 015A 

Entry Active: BCDEHL — OZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

I 761 H— IMOV I A| Hi-- A | BCDEHL-AOZSPI I 

I 77 1 |CALL|018F| I | BCDEHL-AOZSPI I 

Block At 0140 (code), A86 = 015F 

Entry Active: BCDEHL — OZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

| 78| L | MOV I A I L| A | BCDEHL-AOZSPI | 

| 79| |CALL|018F| | I BCDEHL-AOZSPI | 



Block At 0144 (code) , A86 = 0164 

Entry Active: BCDEHL — OZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

I 811 HL iINX | H| I HL | BCDEHL — OZSPI I 

I 821 |MVI I A | 20 1 A | BCDEHL-AOZSPI I 

I 831 I CALL | 0165 I I | BCDEHL-AOZSPI I 

Block At 014A (code) , A86 = 016C 

Entry Active: BCDEHL — OZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

I 84 |B | MOV I A I B| A | BCDEHL-AOZSPI I 

I 85 1 |CALL|018F| | | BCDEHL-AOZSPI I 
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Block At 014E (code) , A86 = 0171 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 

I 86 1 |JMP 10123 1 I I BCDEHL-AOZSPI 

Block At 0151 (code) , A86 » 0174 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 

I 911 I CALL | 0172 | | I BCDEHL-AOZSPI 



Block At 0154 (subr) , A86 = 0177 

Entry Active: BCDE AOZSPI Exit Active: 



|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

| 921 |LHLD|0215| I HL I BCDEHL-AOZSPI I 

I 93 1 HL ISPHLl I I I BCDEHL-AOZSPI I 

I 95 I BCDEHL-AOZSPI I RET | I I I I 

Block At 0159 (subr) , A86 = 017E 

Entry Active: BCDEHL-AOZSPI Exit Active: AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 

| -iOU HL I PUSH I H| | I BCDE AOZSPI 

I 1(52 I — DE I PUSH I D| I IBC AOZSPI 

I 103 I BC I PUSH I B| I I AOZSPI 

| 104 I IMVI I C| 0B|-C I AOZSPI 

I 105 1 I CALL I 0005 I I I AOZSPI 



Block At 0161 (subr) , A86 = 0195 

Entry Active: -AOZSPI Exit Active: 



|stmt#| opcode uses I op I vl I v2 I opcode kills i live regs I 

I 106 1 I POP | B| |BC |BC AOZSPI I 

I 107 1 [POP I D| I — DE I BCDE AOZSPI I 

| io8| | POP | H| I HL | BCDEHL-AOZSPI I 

I 109 I BCDEHL-AOZSPI I RET I I I I I 

Block At 0165 (subr) , A86 = 01A8 

Entry Active: BCDEHL-AOZSPI Exit Active: AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 
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1121 HL 

1131— DE 

114 I BC 

1151 

116 1 A 

117 1 



I PUSH 
I PUSH 
I PUSH 
IMVI 
I MOV 



HI 
D| 
B| 
CI 
E| 



CALL I 0005 I 



02 
A 



-C 

E- 



BCDE AOZSPI 

BC AOZSPI 

AOZSPI 

AOZSPI 

AOZSPI 

AOZSPI 



Block At 016E (subr) , A86 
Entry Active: 



01C1 

—AOZSPI Exit Active: 



|stmt#| opcode uses 



op I vl I v2 | opcode kills I live regs I 



118 | | pop 

1191 I POP 

1 20 I I POP 



B| 
D| 
HI 



| BC |bc AOZSPI I 

| — DE | BCDE AOZSPI I 

I — --HL IBCDEHL-AOZSPI I 



1 121 IBCDEHL-AOZSPI 


IRET 1 1 




| | | 


Block At 0172 (subr) 
Entry Active 


r A86 = 01D4 

: BCDEHL — OZSPI 


Exit Active: BCDEHL-AOZSPI 


1 stmt# I opcode uses 


1 op I vl I 


v2 


I opcode kills 1 live regs 1 


1 i OA 1 


IMVI I A| 
1 CALL 10165 1 


01 


D| A IBCDEHL-AOZSPI I 

I—— ___ ___ iRfnuHr »an7<3DT 1 


1 JLZfl | — — — —————— 

1 lOCl _ 


1 1ZD | — 




Block At 0177 (code) , 
Entry Active: 


A86 = 01D9 
BCDEHL— OZSPI 


Exit Active: BCDEHL-AOZSPI 


|stmt#| opcode uses 


1 op 1 vl | 


v2 


I opcode kills I live regs 1 


1 lOAl— 


IMVI 1 A I 
1 CALL 10165 1 


0/ 


U A IBCDEHL-AOZSPI 1 

1 —_— _.___ _ __ 1 nrriFUT — A07CDT 1 


1 ±zo|— 

1 1 97 1 __._— _— — — 


I ±Z/ 1 




Block At 017C (subr) , 
Entry Active: 


A86 = 01DE 
BCDEHL-AOZSPI 






|stmt#| opcode uses 


1 op I vl | 


v2 


1 opcode kills I live regs 1 


1 128 IBCDEHL-AOZSPI 


IRET I I 




| | | 


Block At 017D (code) , 
Entry Active: 


A86 = 01DF 
nrnPHT —a - 




Exit Active: BCDEHL-A 


D\~UL,tlu l\ 




|stmt#| opcode uses 


1 op I Vl | 


v2 


I opcode kills 1 live regs 1 


1 132 1 A 

1 1331 A 

1 134 1 


lANI I OF I 
ICPI I 0A| 
IJNC 101891 




| AOZSPI I BCDEHL-A I 

| OZSPI IBCDEHL-AO 1 

1 — — ___ ___ 1 RPHIPUT — zv 1 
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Block At 0184 (code) , A86 = 01E8 
Entry Active: BCDEHL-A— 



Exit Active: BCDEHL-AOZSPI 



jstmt#| opcode uses 


1 op 


I vl | v2 


opcode kills I live regs I 


1 1361 A 

1 1 "57 1 _. — — — 


lADI 
IJMP 


1 30 1 
I018BI 1 


AOZSPI I BCDEHL-AOZSPI | 


1 1j/ 1 — "— — 





Block At 0189 (code) , A86 « 01ED 
Entry Active: BCDEHL-A 



Exit Active: BCDEHL-AOZSPI 



|stmt#| opcode uses 


1 op 


vl | v2 


opcode kills 


I live regs I 


| i4o| a 


lADI 


37| 


AOZSPI 


1 BCDEHL-AOZSPI I 



Block At 018B (code) , A86 = 01EF 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 

I 141| |CALL|0165| I I BCDEHL-AOZSPI 



Block At 018E (subr) , A86 = 01F2 

Entry Active: BCDEHL-AOZSPI Exit Active: 



|stmt#| opcode uses I op I vl | v2 I opcode kills 
I 142 I BCDEHL-AOZSPI I RET I | I 



live regs 



Block At 018F (subr) , A86 = 01F3 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-A- 



|stmt#| opcode uses 



op 



vl | v2 | opcode kills 



live regs I 



145 1 AOZSPI I PUSH I PSWl 

146 1 A |RRC | I 

147 1 A |RRC ! | 

148 1— A IRRC I | 

149| A IRRC 1 I 

150 1 |CALL|017D| 



I IBCDEHL-A- 

I ■ AO I BCDEHL-A- 

| AO | BCDEHL-A- 

I AO — — IBCDEHL-A- 

| AO | BCDEHL-A- 

I IBCDEHL-A- 



Block At 0197 (code) , A86 = 0208 
Entry Active: BCDEHL 



Exit Active: BCDEHL-AOZSPI 



|stmt# I 


opcode uses 


1 op I vl | v2 


opcode kills I live regs I 


I i m 1 - 




IPOP I PSWl 
|CALL|017D| 


; AOZSPI I BCDEHL-AOZSPI I 

— — — — — — I RrnPHi ari7QPT 1 


1 1D1 1 ■ 

1 1 RTl. 




I lOZ | - 




1 DV^iJEjIlLi rXKjCiOCl. 1 
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Block At 019B (subr) , A86 = 0211 

Entry Active: BCDEHL-AOZSPI Exit Active: 



|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 
I 153IBCDEHL-AOZSPI I RET I | I I 



Block At 019C (subr) , A86 = 0212 

Entry Active: B-DEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 



|stmt# | 


opcode uses 


1 op I vl | 


v2 I opcode kills I live regs I 


I i <zi i - 




1 MVI 1 C | 
I CALL 10005 I 


no 1 r> __ __ _ iRrnPHT -an7QDT 1 


1 13/ 1" 

l i «;« l - 




1 — _ _ _ _ 1 nrnfUT — ah7Qdt 1 


1 loo i - 







Block At 01A1 (subr) , A86 = 0217 

Entry Active: BCDEHL-AOZSPI Exit Active: 



|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 
I 159 I BCDEHL-AOZSPI I RET I I I | 



Block At 01A2 (subr) , A86 = 0218 

Entry Active: BCDEHL Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs 

I 163 1 ILDA 10 213 1 I A I BCDEHL-A 

I 164 1 A ICPI I 80 I I OZSPI | BCDEHL-AOZSPI 

I 165 1 Z IJNZ I01B3I I I BCDEHL-AOZSPI 



Block At 01AA (code) , A86 = 0222 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl | v2 I opcode kills I live regs 

I 169 1 I CALL |0 ICE I I I BCDEHL-AOZSPI 



Block At 01AD (code) , A86 = 0225 





Entry Active: BCDEHL-A Exit Active: BCDEHL-A-ZSPI 


|stmt# | 


opcode uses I op I vl I v2 I opcode kills I live regs I 


1 170 1- 

1 1711- 


A |ORA | A| I AOZSPI I BCDEHL-A-ZSPI 1 

- _ 7 1 T7 IninO 1 |_ __. lnr , nE , HTA7CDTl 





Block At 01B1 (subr) , A86 = 022C 

Entry Active: BCDEHL-A-ZSPI Exit Active: 
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|stmt#| opcode uses I op I vl I v2 I opcode kills | live regs 

I 173 1 ISTC I I I ■ 0- IBCDEHL-AOZSPI 

I 174 | BCDEHL-AOZSPI I RET I I I I 



Block At 01B3 (subr) , A86 = 022E 

Entry Active: BC A Exit Active: 



jstmt#| opcode uses I op I vl I v2 I opcode kills | live regs I 



177 I A I MOV 

178 1 |MVI 

179 1 ■ A IINR 

180 I A I STA 

1831 ILXI 

184 1 — DEHL I DAD 

186 | I MOV 

188 I A I0RA 

189 | BCDEHL-AOZSPI I RET 



E 
D 
A 
0213 
H 
D 
A 
A 



A 
00 



0080 
M 



A-Z 

HL 

HL — 

AOZSPI 



IBC-E A 

IBCDE A 

IBCDE — -A 

IBCDE 

IBCDEHL 

IBCDEHL 

IBCDEHL-A 

I BCDEHL-AOZSPI 



Block At 01C1 (subr) , A86 = 0247 

Entry Active: B HL-A — ■ Exit Active: BCDEHL-AOZSPI 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 



1931 A 

194 I A 

196 1 

197 1 

198 1 



XRA I A I | AOZSPI IB HL-AOZSPI 

STA I007CI I IB HL-AOZSPI 

LXI I D|005C|— DE | B-DEHL-AOZSPI 

MVI I C| 0FI-C IBCDEHL-AOZSPI 

CALL I 0005 I I I BCDEHL-AOZSPI 



Block At 01CD (subr) , A86 = 0254 

Entry Active: BCDEHL-AOZSPI Exit Active: 



|stmt#| opcode uses I op I vl I v2 I opcode kills I 
I 200 I BCDEHL-AOZSPI I RET I | I I 



live regs 



Block At 01CE (subr) , A86 = 0255 

Entry Active: BCDEHL-AOZSPI Exit Active: 



•AOZSPI 



stmt# I opcode uses I op I vl I v2 I opcode kills I live regs 



2031 HL- 

204 1 — DE 

205 I BC- 

206 1 

207 1 

208 1 



I PUSH 
I PUSH 
I PUSH 
I LXI 
I MVI 



HI 

D| 

B| 

DI005C 

C| 14 



CALL I 0005 



•C 



BCDE AOZSPI 

BC AOZSPI 

AOZSPI 

AOZSPI 

AOZSPI 

AOZSPI 
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Block At 01D9 (subr) , A86 = 026F 

Entry Active: AOZSPI Exit Active: — 

|stmt#| opcode uses I op I vl I v2 I opcode kills I live regs I 



I 209 1 I POP I 

I 210 1 | POP I 

I 2111 I POP I 

I 212IBCDEHL-AOZSPI I RET I 



B| 

D| 

HI 

I 



BC IBC AOZSPI I 

— DE |BCDE AOZSPI I 

HL I BCDEHL-AOZSPI I 



Block At 01DD (data) , A86 = 0282 
Entry Active: 



Exit Active: 



stmt# I opcode uses | op I vl I v2 I opcode kills 



live regs 



1 2151 


1 216 1 


1 219 1 


1 2201 


1 223 1 



DB 


100161 I 


DB 


100201 1 


DS 


100021 I 


DS 


100021 I 


DS 


100401 I 



Block At 0257 (code) , A86 = 02FC 

Entry Active: BCDEHL-AOZSPI Exit Active: BCDEHL-AOZSPI 



stmt# I opcode uses I op I vl I v2 I opcode kills 



live regs I 
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A (A86) parameter, 
A86 output file, 1 
ASM input file, 1 
ASM-86, 13 



B 



B (Block Trace) parameter, 6, 

10 
Basic Block, 6, 11 
Basic Block address, 7 
Basic Block Header, 11 



C (Compact) parameter, 8, 10 

code areas, 14 

code segments, 8 

command line, 5 

comment field, 13 

CSEG directives, 10 



data areas, 14 
data flow analysis, 6, 8 
data segments, 8 
differences in assembly 
language formats, 13 
disassemblers, 14 
DSEG directives, 10 



equate statement, 15 
error codes, 25, 26 
error messages, 25 
expression translation, 14, 

15 
expressions, 15, 16 



flags, 7 

I 

input file, 1 



J (Jump) parameter, 9 
Join Blocks phase, 2 



L (List) parameter, 9 
label generation, 8, 14, 17 
letter denotations for 

registers and flags, 7 
List Blocks phase, 2 
live function, 17 



M 



M (Memory) register, 15 
macros, 1 

memory overflow, 27 
monitoring the translation, 
2, 9 



N 



N (Number) parameter, 9 
NO parameter, 11 



operand field abbreviations, 

14 
operand field translation, 14, 

16 
operand fields, 13 
operation code, 13 
ORG statement, 13 
output files, 1 
output line, 13 
overlays, 1, 3 



P (PRN) parameter, 6 
parameter list, 5 
parameter syntax, 5 
parameters, 3, 5 
PIP, 9 

PRN file, 1, 25 
processed files, 3 
program fragments, 13 
program graph, 27 
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program segment, 13 
Psuedo-assembly Process error 
messages, 25 



R 



R (Return) parameter, 10 
register translation, 15 
register usage, 13 
registers, 7 
repeat loops, 1 
root module, 1 



S (Segment) parameter, 8, 10 
Setup Blocks phase, 2 
short function, 17 
short jump analysis, 9 
Symbol Setup phase, 2 
syntax, 5 



T (TMP) parameter, 6 
temporary ($$$) file, 1 
Translate-86 error messages, 

25, 26 
Translate-86 phase, 2 
translated program format, 13 
translation parameters, 5 
translation phases, 2 
translation table, 17 

16-bit register translation, 
15 

80 parameter, 10 

8080 operation code, 17 

8080 program fragments, 13 

8080 program origin, 13 

8080 register usage, 13 

8080 source program, 1 

8086 program segment, 13 
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